home *** CD-ROM | disk | FTP | other *** search
/ LG Super CD / LG Super CD.iso / vx6000 / pure voice / readme.txt < prev    next >
Encoding:
Text File  |  2001-02-27  |  8.4 KB  |  227 lines
  1. =====================================
  2.  QUALCOMM PureVoice Windows SDK v2.1
  3. =====================================
  4.  
  5. This QUALCOMM PureVoice SDK provides High level API's and Mid level API's 
  6. that manipulates the wave and PureVoice files for 32-bit system(Win95, 
  7. WIN98, NT 4.0).
  8.  
  9.  
  10. High Level
  11.   * Converts a wave file (8-kHz, 16-bit PCM) into PureVoice(.qcp)
  12.     file and vice versa as well as memory based conversion.
  13.  
  14.  
  15. Mid Level
  16.   * Opens .qcp file in either READ or WRITE mode
  17.   * Closes .qcp file
  18.   * Reads blocks of PureVoice data and decodes to linear 8-kHz, 16-bit PCM 
  19.     samples.
  20.   * Writes blocks of PCM data into PureVoice format after encoding.
  21.   * Retrieves a length of file in blocks.
  22.   * Retrieves ablock size in milliseconds.
  23.  
  24. =========
  25.  Content
  26. =========
  27.   * readme.txt (this file)
  28.  
  29. Files for Qualcomm PureVoice Library (QPL):
  30.   * Qpl.dll  - PureVoice libraray
  31.   * Qpl.lib  - Import LIB for QPl.dll
  32.   * Qpl.h    - Contains the necessary defines and COM classes.
  33.   * QplCom.h - Contains basic COM defines/functions and other misc 
  34.                defines for Qualcomm PureVoice Library.
  35.  
  36. A sample program consists of Microsoft VC++ 6 project:
  37.   * test.cpp - Sample source code
  38.   * test.dsp - Project file
  39.   * test.dsw - Project file
  40.   * test.wav - Sample .WAV input file 
  41.  
  42. Command line wav<->qcp file conversion tool which can convert wave files 
  43. into QCP files in different rate setttings, including a fixed fullrate:
  44.   * PVConv.exe
  45.  
  46. =========================================================
  47. Objects and their interfaces (see qpl.h for more detail)
  48. =========================================================
  49.  
  50.  QPLPvQcpFile
  51.   |
  52.   --> IQPLConvertFile [converts .qcp <-> .wav files]
  53.   |     |
  54.   |     |-ConvertFile  convert qcp to wav and vice-versa
  55.   |     |-GetProgress  get progress of conversion
  56.   |
  57.   --> IQPLQcpFile [reads or writes .qcp files]
  58.         |-Open         open file
  59.         |-Close        close file
  60.         |-Read         read and decode
  61.         |-Write        encode and write
  62.         |-GetLength    get file length in milliseconds
  63.     |-GetBlockSize get size of a block in milliseconds
  64.  
  65. ------------------------------------------------------------------------------
  66.  
  67.  QPLPvQcpFile1
  68.   |
  69.   --> IQPLConvertFile1 [converts .qcp <-> .wav files]
  70.   |     |
  71.   |     |-ConvertFile  convert qcp to wav and vice-versa
  72.   |     |-GetProgress  get progress of conversion
  73.   |
  74.   --> IQPLQcpFile1 [reads or writes .qcp files]
  75.         |-Open         open file
  76.         |-Close        close file
  77.         |-Read         read and decode
  78.         |-Write        encode and write
  79.         |-GetLength    get file length in milliseconds
  80.     |-GetBlockSize get size of a block in milliseconds
  81.  
  82. Note: 
  83.  
  84. QPLPvQcpFile1 is exactly same as QPLPvQcpFile except that one can specify
  85. the encoding level to the following:
  86.  - QPL_QCELP_FULL_MAX    full max rate (variable rate 14000 bps max) 
  87.  - QPL_QCELP_FULL_FIXED  full fixed rate (14000 bps)
  88.  - QPL_QCELP_HALF_MAX    half max rate (variable rate 6800 bps max)
  89.  - QPL_QCELP_HALF_FULL   half fixed rate (6800 bps)
  90. QPL_QCELP_FULL_MAX is default.
  91.  
  92. ------------------------------------------------------------------------------
  93.  
  94.  QPLPvCodec
  95.   |
  96.   --> IQPLPvHrCodec [PureVoice Fixed Half Rate Codec (6800 bps)]
  97.         |
  98.         |-Reset    initialize CODEC
  99.         |-GetInfo  get info on CODEC
  100.         |-Convert  encode or decode depending on mode set in Reset
  101.  
  102. ------------------------------------------------------------------------------
  103.  
  104.  QPLPvCodec1
  105.   |
  106.   --> IQPLPvVrHrCodec [PureVoice Variable Half Rate Codec (Max 6800 bps)]
  107.         |
  108.         |-Reset    initialize CODEC
  109.         |-GetInfo  get info on CODEC
  110.         |-Convert  encode or decode depending on mode set in Reset
  111.  
  112. ------------------------------------------------------------------------------
  113.  
  114.  QPLPvCodec2
  115.   |
  116.   --> IQPLPvFrCodec [PureVoice Fixed Full Rate Codec (14000 bps)]
  117.         |
  118.         |-Reset    initialize CODEC
  119.         |-GetInfo  get info on CODEC
  120.         |-Convert  encode or decode depending on mode set in Reset
  121.  
  122. ------------------------------------------------------------------------------
  123.  
  124.  QPLPvCodec3
  125.   |
  126.   --> IQPLPvVrFrCodec [PureVoice Variable Full Rate Codec (Max 14000 bps)]
  127.         |
  128.         |-Reset    initialize CODEC
  129.         |-GetInfo  get info on CODEC
  130.         |-Convert  encode or decode depending on mode set in Reset
  131.  
  132. ------------------------------------------------------------------------------
  133.  
  134. ==============================
  135. CHANGES SINCE 2.0
  136. ==============================
  137. Added validation of wave file. Accept 8000 Hz and 16-bit only.
  138.  
  139. Switched descriptions for -e 2 and 3 to be correct for PVconv.exe
  140.  
  141. Sets the avgBitsPerSec correctly for each mode(no longer fixed at 8000)
  142.  
  143. Sets sizeInPackett in the 'vrat' chunk for fixed full-rate mode also to 
  144. support CDMA MSM3100 and beyond VoiceMemo support. 
  145.  
  146. Added PVConv.exe example with SDK, which is a command line interface
  147. which converts PCM (mono, 8 kHz, 16-bit) wave file to PureVoice qcp file using 
  148. different encoding mode(Variable Rate, Full Fixed, Half Max Variable and 
  149. Half Fixed) and vice-versa.
  150.  
  151. ==============================
  152. FAQ
  153. ==============================
  154. Q: There is one extra byte at the end of the file.
  155. A: This is by design. The QCP file will always word aligned. So if the real 
  156.    size happens to be odd size, then we'll add a pad byte.
  157.  
  158. Q: What's wrong with my test code?
  159.    if ( S_OK != pfn( CLSID_QPLPvCodec3, IID_IQPLPvFrCodec, 
  160.                      (void**)&m_pureVoice ) )
  161.    {
  162.      printf("Can't Create Instance\n");
  163.      return;
  164.    }
  165. A: IID_IQPLPvFrCodec must be IID_IQPLPvVrFrCodec and make sure m_pureVoice is 
  166.    a type of IQPLPvVrFrCodec*
  167.  
  168.  
  169. ==============================
  170. LICENSE AND LEGAL INFORMATION
  171. ==============================
  172.  
  173. QUALCOMM Incorporated
  174.  
  175.  
  176. License Terms for the freeware versions of the PureVoice Player/Recorder and PureVoice
  177. Converter for Windows/95, Windows/98, Windows/NT, Macintosh, and Solaris platforms, the
  178. PureVoice ActiveX Plug-in for Windows/95, Windows/98, and Windows/NT, and the PureVoice
  179. encoder and decoder for SCO Unix,  (collectively the "QUALCOMM PureVoice Software").
  180.  
  181.  
  182. QUALCOMM grants to the user a nonexclusive license to use this PureVoice software
  183. solely for user's own personal or internal business purposes.  The user may not
  184. commercially distribute, sublicense, resell, or otherwise transfer for any
  185. consideration, or reproduce for any such purposes, the PureVoice software or any
  186. modification or derivation thereof, either alone or in conjunction with any other
  187. product or program.  Further, the user may not modify the PureVoice software.
  188.  
  189.  
  190. THE PUREVOICE SOFTWARE IS PROVIDED TO THE USER ''AS IS.''  QUALCOMM MAKES NO WARRANTIES,
  191. EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THE PUREVOICE SOFTWARE AND/OR ASSOCIATED
  192. MATERIALS PROVIDED TO THE USER, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF
  193. MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. QUALCOMM
  194. DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR REQUIREMENTS,
  195. OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS
  196. IN THE SOFTWARE WILL BE CORRECTED.  FURTHERMORE, QUALCOMM DOES NOT WARRANT OR MAKE ANY
  197. REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE SOFTWARE OR ANY
  198. DOCUMENTATION PROVIDED THEREWITH IN TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY,
  199. OR OTHERWISE. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY QUALCOMM OR A QUALCOMM
  200. AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF T
  201. HIS WARRANTY.
  202.  
  203.  
  204. LIMITATION OF LIABILITY - QUALCOMM IS NOT LIABLE FOR ANY CLAIMS OR DAMAGES WHATSOEVER,
  205. INCLUDING PROPERTY DAMAGE, PERSONAL INJURY, INTELLECTUAL PROPERTY INFRINGEMENT, LOSS OF
  206. PROFITS, OR INTERRUPTION OF BUSINESS, OR FOR ANY SPECIAL, CONSEQUENTIAL OR INCIDENTAL
  207. DAMAGES, HOWEVER CAUSED, WHETHER ARISING OUT OF BREACH OF WARRANTY, CONTRACT, TORT
  208. (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR OTHERWISE.
  209.  
  210.  
  211. Copyright ⌐ 2001 by QUALCOMM Incorporated.  All rights reserved.
  212.  
  213.  
  214. PureVoice(TM) is a registered trademark of QUALCOMM Incorporated.
  215. QUALCOMM and Eudora are registered trademarks and QUALCOMM is a registered service
  216. mark of QUALCOMM Incorporated.
  217. Windows is a trademark of Microsoft Corporation registered in the U.S. and other countries.
  218.  
  219.  
  220. All other trademarks and service marks are the property of their respective owners.
  221.  
  222.  
  223. Feb. 2001
  224.  
  225.  
  226.  
  227.